Provision Google Wallet (v1)

Initiates the provisioning of a card to Google Wallet.

Query POST

Overview

Initiates the provisioning of a card to Google Wallet.

POST (/internal/v1/cards/{token}:provision-google-wallet)

Parameters

  • token (path) (required): Internal unique identifier for the card. See CardToken model.

Request Body

Responses

200 OK

The necessary details to complete the card provisioning.

400 Bad Request

Bad Request Response

500 Internal Server Error

Internal server error response

Architecture

5 properties

Provision Google Wallet request body.

deviceId string
required

Unique identifier of the user’s Google device. Must be between 1 and 24 characters.

Min length: 1
Max length: 24
deviceType string
required

Type of device where the digital wallet token will be provisioned.

Allowed values: MOBILE_PHONE TABLET WATCH
provisioningAppVersion string
required

Version of the application initiating the provisioning request.

Min length: 1
Max length: 50
walletAccountId string
required

The user's Google Wallet account ID, provided by Google during the provisioning process.

Min length: 1
Max length: 50
stableHardwareId string

A stable hardware identifier for the user's device, such as ANDROID_ID for Android devices.

Min length: 1
Max length: 50
1 property

The necessary details to complete the card provisioning.

provisioningData string
required

A provider-specific cryptographic payload required to complete card provisioning. This value is returned by the issuer/processor and must be passed unmodified into the Google wallet SDK on the device.

7 properties

Bad Request Response

code string
Allowed values: urn:plmr:cards:connector:CARD_NOT_FOUND urn:plmr:cards:connector:CARD_ALREADY_TERMINATED urn:plmr:cards:connector:INVALID_CLIENT_PUBLIC_KEY urn:plmr:cards:connector:INVALID_CARD_STATE urn:plmr:cards:connector:IN_APP_PROVISION_NOT_ALLOWED urn:plmr:cards:connector:INVALID_CERTIFICATE_CHAIN
message string
requestId string
fieldErrors array [object]
7 properties

Internal server error response

code string
Allowed values: urn:plmr:cards:connector:CARD_NOT_FOUND urn:plmr:cards:connector:CARD_ALREADY_TERMINATED urn:plmr:cards:connector:INVALID_CLIENT_PUBLIC_KEY urn:plmr:cards:connector:INVALID_CARD_STATE urn:plmr:cards:connector:IN_APP_PROVISION_NOT_ALLOWED urn:plmr:cards:connector:INVALID_CERTIFICATE_CHAIN
message string
requestId string
fieldErrors array [object]